home *** CD-ROM | disk | FTP | other *** search
/ Best of www.BestZips.com (Collector's Edition) / Best of WWW.BESTZIPS.COM Collector's Edition (JCSM Shareware) (JCS Marketing).ISO / internet / iag093.zip / itsagif / manual.txt < prev    next >
Text File  |  1996-09-03  |  7KB  |  133 lines
  1.                                 I t s a g i f
  2.                                  M a n u a l                      
  3.  
  4. This is a very brief manual for itsagif. A larger manual may be found
  5. online at http://www.cafe.net/peda/iag/man.html.
  6.  
  7. The program begins with a splash screen. You can dismiss the splash screen
  8. by pressing a key or button; itsagif then asks for a PICT file to open.
  9. After a file is chosen, itsagif will display an image preview and a control
  10. window, both of which are named after the chosen file.  Opening a file
  11. named "Example" will result in the following control window:
  12.  
  13.             (images are available in the online manual)
  14.  
  15. We will now go over each element of the control window, from top to bottom.      
  16.  
  17.    Source Controls      
  18.  
  19.    The source controls display information about the source image.
  20.  
  21. Size: 199x204 (159K)          
  22.    This control displays the size of the original image. Our example
  23.    image is 199 pixels wide and 204 pixels high. When placing the GIF file
  24.    in some HTML the size should be included. For our example, the
  25.    appropriate HTML would be "<img src="Example.gif" width=199 height=204>".
  26.  
  27.    The memory requirements are listed after the image dimensions. Our
  28.    example image uses 159K when stored as a 24-bit image without any
  29.    compression.
  30.    
  31. 2254 colours
  32.    This control displays the number of colours present in the original image; 
  33.    our example image has 2254 distinct colours.      
  34.    
  35. Destination Controls      
  36.    The destination controls determine how the image is converted into a GIF
  37.    image.
  38.  
  39. Size: 199x205 (71.9K)
  40.    This control displays the size of the produced image; the dimensions of
  41.    the produced image match those of the original image. However, the
  42.    produced image will be a 71.9K GIF file. The GIF file will be identical
  43.    to the preview image if you are previewing the image with a 24-bit video
  44.    card. If you are previewing the image with a 1,2,4,8, or 16-bit video
  45.    card the produced GIF file will be as good or better than the preview
  46.    image.
  47.    
  48.    The remaining destination controls impact the quality and memory
  49.    requirements of the produced GIF file. After changing any of the
  50.    controls, itsagif will automatically recompute the preview image and
  51.    memory requirements. While computing the memory requirements itsagif may
  52.    display lower estimates of the size (for example ">36K"...">44K"...
  53.    ...">60K"..."71.9K").
  54.  
  55. 2254 colours
  56.    This control displays the number of colours used in the produced image.
  57.    You may specify the number of colours by entering a value into this
  58.    control. Using fewer colours will usually reduce the size of the produced
  59.    GIF file.
  60.  
  61. 9 passes
  62.    This control displays the number of passes needed to render the image.
  63.    Each pass can paint at most 256 colours. You may specify the number of
  64.    passes by entering a value into this control. Using fewer passes will
  65.    usually reduce the size of the produced GIF file.
  66.  
  67. First pass: 256 colours
  68.    This control displays the number of colours used to paint the first pass.          
  69.    Using a small number of colours on the first pass allows viewers to get a
  70.    quick preview of image. To see what the image will look like after the
  71.    first pass, set this control as desired and subsequently specify that one
  72.    pass is to be used to render the image (using the # of passes control
  73.    described above). You will also see the memory size of the first pass;
  74.    14,400 baud modems transfer approximately 1K per second.
  75.  
  76. Later passes: 255 colours
  77.    This control displays the number of colours used to paint all passes after          
  78.    the first pass.
  79.  
  80. Background (FFFFFF)
  81.    This control displays a small swatch of colour that represents the image's
  82.    intended background colour along with the HTML description of that colour.
  83.    Clicking on the colour allows you to choose a new colour; option-clicking
  84.    gives you finer control over the colour chosen. Our example image has a
  85.    white background (the default) which is specified in HTML as
  86.    "bgcolor=#FFFFFF" in the body tag, as follows: "<body bgcolor=#FFFFFF>".
  87.    Itsagif will display the background colour around the preview image as
  88.    well as over portions of the image that have been marked as transparent.
  89.  
  90. Transparency
  91.    When this control is checked, portions of the image are transparent. To
  92.    specify a transparent colour, move the pointer over the desired colour on
  93.    the preview image and click once. Click over other colours to specify
  94.    multiple transparency colours. Clicking over a transparent region causes
  95.    the underlying colour to become opaque again. the delete key removes
  96.    the most recently added transparency colour.
  97.    
  98.    Unchecking this control will disable transparency.
  99.  
  100. Interlace first pass
  101.    When this control is checked, the first pass of the image will be stored
  102.    in an interlaced manner. Interlacing the first pass allows viewers to
  103.    get a very quick idea of what the image will look like as it is being
  104.    downloaded. Interlacing usually increases the memory size, although only
  105.    slightly.
  106.    
  107. Interlace later passes
  108.    When this control is checked, all passes after the first pass are
  109.    interlaced. Most browsers will present the image to the viewer in less
  110.    time if later passes are not interlaced.                                      
  111.    
  112. Use global colour table
  113.    When this control is checked, a single colour table is used for all
  114.    passes, instead of one colour table per pass. Images with a global
  115.    colour table are compatible wuth more (older) browsers and utilities.
  116.    Multiple passes may still be used to provide sharp previews.
  117.  
  118.           *                         *                            *
  119.  
  120. Be warned that itsagif requires *alot* of memory for larger continuous-tone
  121. images, as it keeps both the original and preview image in memory at 24-bits.
  122. Furthermore, additional structures are used to maintain exact knowledge
  123. about every colour in the image. Large continuous-tone images take a *long*
  124. time to load, as these structures are built up as the image is loaded. The
  125. algorithms may be improved in the future, if there is enough demand - the
  126. program was written mainly out of interest and to demonstrate that GIF files
  127. can contain more than 256 colours.
  128.  
  129. ____________________________________
  130. (1) The Graphics Interchange Format(C) is the Copyright property of
  131. CompuServeIncorporated. GIF(sm) is a service mark property of CompuServe
  132. Incorporated.
  133.